I. MEETING NOTES -JUNE 3, 1984 
A L a iaa 


A longish 4 hour meeting at Idle Day Drive involved: 


LONG ISLAND 
SINCLAIR TIMEX 


GROUP 


Centerport, N.Y. 11721 


a) Paul D. tried to log on to compuserve but, while we could get in, the password (which doen't 
show on the screen when typed) must have been mistyped and the system threw us out. Rather 


than hold up the meeting (or run up the phone bill) we gave up after 3-4 tries. 


the MD-2 Modem and ZCOMM do work. 


b) Nazir P. showed us his translation of the 


Rest assured, 


ZX Spectrum arcade game "Galdtoids" (Public Domain) 


and the numerous changes in ROM calls, particularly the use of the "blank" portion of the 


Spectrum ROM, which were necessary to adapt it to the 2068. 


c) Paul D. demoed "Transylvanian Tower", a Spectrum adventure-maze game sent to'n 


Por review by 


Richard Shepherd software. A considerable amount of work (detailed inside) vas necessary to 


get even this BASIC program to run. 


d) Rich B, demoed Vu-file from Psion and its included 


to Tom Woods Pro/file, but formatting may be a little more rigid. 


e) FIRSTLOADR - Zx81 upload program from SYNTAX, was tried several times, without success, Heinz H. 
` feels his "smoother", to be demoed next meeting, may be the answer. 


critical. 


ya 


"Gazeteer" program, Speed seems comparable 


a 


Volume setting is clearly 


£) Group purchasing was dicussed, but little consensus or advantage was found, 


g) A discussion of "piracy" (read theft 


) lead to a unanimous voice vote that such was against group 


policy, the possible exception being companies which have folded. More discussion next time. 


II. NEXT MEETING IS SCHEDULED FOR 7 JULY (SATURDAY) AT 3:00PM 
EE ECR YS JULY mee 


Location: 9 Dartmoor Drive, 


bring any special software, hardware items you'd like to demo. 


That simple game Program you wrote last year and which is now to 
learning aid for the beginner (especially if you've documented i 
"library" tape of public domain (or member donated) software and of c 


Programs between members, 
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FOR BEGINNERS ONLY: FIRST LOADR 


An outstanding achievement by David Ornstein and a great public service by 
SYNTAX, FIRSTLOADR lets you upload your TS1000 BASIC programs to the 2068. 

Unfortunately, several of the beginners (and more advanced programmers too) 
have had trouble understanding, entering and/or using FIRSTLOADR. Based on 
the questions most frequently asked, we can offer the following tips: 


@ Copyrishe 1354 


Pid. i 
l. The data shown in Syntax (December 83) on page 14 is a Donnelly 
translation table, The machine code (MC) program, (P15) . 
which runs from 45000 to 45234, uses this table to con- BREAKING INTO THE TRANSYLVANIAN TOKER 


vert ZX/TS code to its 2068 equivalent. That is, each 
number in the table is the CODE of one of the 255 char- 


Transylvanian Tower, by Richard Shepherd Software -D} p ĝi 
acters you can use. Several characters are not directly vxo: h: pher sis a 3-D MAZE adventure 


translatable, and these have been replaced by "32" or a game written entirely in BASIC, The game begins with an external view of 
blank space. Check the character tables in the backs of the "tower" and 3 brief introductary screens of instructions. fo read the 
borth manuals for a comparison. Right now, CLEAR 43999 & instruction booklet which comes with the cassette though, before beginntag 


play. You'll get a chance to do this in the 2 minute delay, while the com 


2. To get these numbers into the computer, look at Fig.1 in puter sets up the first (and-each succeeding) maze, 
this months article on Transylvanian Tower. Lines 100 
to 140 serve as a rudimentary INPUT routine which lets 


The game is played on 5 L 1 f th x h l X 
ga put ta 10 bycei at k tles. TE you GOTO 100, ould y evels o e tower, eac evel is an 8 X 3 ca of 


be expected to put in a value for V. Enter 44000 for interconnected rooms, some of which hold treasures (e.g. a silver cross) 
example, to begin entering data in the look-up table. and many of which hold deadly vampire bats. Your task is to proceed frea . 


The program will print the current memory location and the bottom or Ist level, where there are no treasures or bats, up throzsa 
wait for your input, 't'. Again if you were just start- 


h i 
ing out, you would enter 32. Next you'd enter 130,129 etc. tougher and tougher challenges to level 5, kill Count Kreapie and obtain his 
ending with 143 (the lOth byte). treasure. 


3. Now to check what youve done so far, break into the pro- 
gram (or add a line-145 STOP) and GOTO 205. Again you'll 
be asked for a "Start". Enter 44000and you'll see the lne drawing showing 3 walls, ceiling and floor of the room in perspective. 
bytes you just entered arranged just as they are in Syntax, Doors, windows and objects are also represented. If there ís a bac in the 
The program will list 300 bytes (which can be changed by 
editing line 210), so at this each stage you may want to 
BREAK after you've seen what you want. 


In the first level, and in each succeeding one, you are presented with a 


room, he will fly around the cefling until you either kill hia with your su, 
or flee,or are killed by him. 


4. Look at that listing. If any numbers were entered wrong, The game is a very good example of what can be done with SINCLAIR BASIC and” 

POKE the correct value directly. That is, if you see: the Spectrum/TS 2068. The graphics are very good for BASIC and the pace is 
44000 32 130 129 133 136 adequate, if slow during certain phases. Those slow phases are the two zinute 
wait between levels and the agonizingly slow drawing of your situation zap 

You know the 4th value is wrong (it should be 131). So now, (which takes about 30 seconds). 
in immediate mode, POKE 44003, 131. 

5. Repeat the process of steps 2 through 4 until you reach The author has protected his software by jamming the machine stack, so don't 
44255. Next, enter the actual machine language program try to break the program while it is running or you'll restart your machine. 


by going to 100 and letting v = 45000. Fill any excess 
bytes with § or 201. 


Note too, that the Spectrum version will not run on a TS 2068, without signif- 
icant modifications (see companion article), We found the difficulty of the 


6. Triple check the whole entry table and program by GOing to game on a whole adequate, although, firing your gun was not in the least bit 
205 (by the way, lines 10 to 40 and 300 are not needed in this convenient, 
application) and camparing what you have on the screen with the 


errors with direct POKES. 
ie dn a a Tany Overall I'd give TT a rating of 7 out of 10. It is an inpressive achieverenc 


7. SAVE "FIRSTLOADR" CODE a couple of times, for insurance. for BASIC, but could have been better documented 
(You might even want to do this before step 6, just in 
case you mistype a POKE and crash the machine.) 


(e.g. the instructions don't 
tell you how to fire your gun-use the ZERO key). It's price - £6.95 (about 


$11.00) is about right for the U.S. market and a reasonable value for che zccev. 


8. Now, cue up a ZX81 tape (use a 2K or less program for test- 
ing purposes) as described in Syntax.. Volume is critical 
and about all I can tell you is that the program data should 
look like red and black lines in the border somewhat similar 
to the yellow and blue of a 2068 program in width. Too low 


or two high a volume will give nothing or just occasional Vince Item Cost 
flashes. Make sure there is no BASIC program is the machine Suppliers 38.2 
when you RAND USR 45000. pests 2068 $98.32 
e 
9, Enter RANDOMIZE USR 45000, play the tape, and wait for the sects " $99.95 
ý OK. Note that you can stop the process, anytime, by press- 47th St suas iis tai 
ing the 'BREAK' key. Note particularly that Ornstein means " . ` 
“just that key - not Capshift and BREAK. ; Timex z ET 
i TS1000/ 16K 50 so s 
10. Go through your program as described in Syntax, note changes Timex ET 
required and SAVE it before you make them. zebtŠ/ Sunset Modem $ . s 
My first successful firstload was "Memory" a simple 2K Simon Says game from the Gib Joysticks (BP) 2/$8.00 
Mixed Game Bag II tape. The only changes were to redefine variable X, the place Fordham Ra 
to start in the character table, from 28 to 48 (line 140), change the "SAVE" line er 26-1332 * ee 
to add LINE for autorun and add‘OR a$= "y"’to cover the lower case option for re- Radio Sha Thermal Paper 2/33.95 


Playing the game, 


MOONBUGGY : 


t Bob M, has one and is hooked up to the Source 


Moonlander - line 630 the > sign should be <> . * Thanks to Rich B for this tip. 


A CALL ABOUT A PARROT 


John Cox called from the West Coast to find out more about RIST's Parrot. He 
couldn't get through to RIST, but fortunately, they had sent me a schematic. I 
told John what the missing chips and software on his second-hand kit version were 

and hope he does well in assembling it: Is RIST still in business? 


a gee ys H E | OW F R Spectrum BASIC program conversion 


Spectrum BASIC is much closer to ZX81 (TS1000), BASIC than that of the 2068 and 
it was this similarily, which enabled me to rework Transylvanian Tower (TT) for 
the 2068. TT is SAVED as CODE starting at 23552 for 36,500 bytes. The Spe t 
„uses the area from 23552 through 23755 to store the system variables and 3 


Program can begin anywhere after that. In this case, fortunately, BAS- 
23755. j 


tole 
viene 


teja 


Your TS 2068 on the other hand, while keeping system variables -at {3 2 through 
23755 (though they differ in function after 23733), also has asnumber of other 
housékeeping chores tucked away in the 16-24K area. Most notable of these is the 
machine stack which normally sits (with one display file - mode} at 24576 to 


25088., Other items, Chans, etc. are also kept in this area, so having BASIC there 
is not such a great idea, 


OBOOEGAaWUwE 


In order to find out how a BASIC Program is configured,we need to look at that 


es X] 
systems variables file. That is easy enough to do if we use the LOAD ""CODE STARTLOC, ERE A 
BYTES command. Here STARTLOC is the location we want the TS 2068 to start loading z337 > 
code into and BYTES is the number of bytes to load. If we don't know how long a 218 = 
Program is we can leave BYTES blank. >20 

2230 $ 
For the purposes of examining the systems variables (203 bytes) and perhaps a z wb> 
little of the BASIC program then, we do the following: PEE 75o 


1. CLEAR 28551 & NEW - This sets RAMTOP to 28552 and leaves 
whatever we put above it isolated from the BASIC System, 


UZ UR 


2. LOAD"" CODE 28552 - which will load the tape into 28552 
and beyond. To save time while experimenting; you might 
want to stop the tape after 30 seconds or so. The whole 


Program won't LOAD, but you should get the first 1K bytes, 
more or less. 


~~ 


3. LOAD or type in-at least Lines 205 through 295 of the 
Program shown in Fig.l. Then GOTO 205. You'll be asked 
for the starting address. Respond with Ø or 28552. The 
Program will then list the code you just loaded, but will 
offset the effective addresses to reflect the locations 
the bytes originally had. Typical output is shown in Fig.2 


(can be obtained either by COPYing the screen or OPEN #2, 
"P", GOTO205,CLOSE #2). 


CACICILICI abe N 


4s 


4. Prepare a chart, like Fig.3, which lists the systems var- = 
iables and calculate the values of the codes obtained in 2 4 
step 3. The really important addresses are ERR SP, LIST ad $ 
SP, virtually all the bytes from NEWPPC (23618) to MEM z ° 
(23657), RAMTOP 237301-1, and the CHANS data; 23618 to “i & : 
23755. Remember that the values are stored LSB first. As = 2 
an example, to find out where the program starts, let's = 34 
investigate and use the variable PROG. (see PP 262ff of TS ay 4s 2 = z 
2068 manual) So Sy = a5 
233223 2 a (78 
5. Calculate the value of PROG. From Fig.3 we see this is: 33477 “3 2 € 
22535 ae ə zo 
23635 contains LSB = 203 203 22237 Z2. 3 33 as 
23636 contains MSB = 92 X 256= 23552 7 F 33 = “3 5 à > 
4 za mSS 2 +. 322 Ke 
PROGRAM STARTS AT 23755 33°63 x a 22 = 
a 2e-Vie < 3 2 2 
23717 z ` z z 2 
Does it? Take a look at 28754. (offset 5000 from 2aI3 4 a ï Le 
23754) We see the 128 (80H) we are supposed to see SEJ i 5st 2. Z44] 2 
before the program starts (see Page 255: of 2068 “23737 ~ 16 243 LĒ 
manual). Next comes: g eee = Cen -5 
a x "ra © n 
0 1 77 0 244 50 ete. 53 a3 SIGE? oss 
š 22742? Ig 4: So lis 
Line numbers are stored in the normal way in 2 bytes, 227 b7 ə Sr 3 =] 
so the program starts at line #91. The next two bytes 22738 50 33. nie 
say the rest of the line is 77 bytes long. Look at 43237 Saa aa =" 
28836 (77 + the 4 bytes we've just looked at). We 2 2595 “st za Ta 
see code for line 2. You could interpret each byte 23732 a? 2 45 
of code to determine what the Program does, but there 23797 -F es 
- is an easier way. aa = s8 +16 
S 28 =3 
6. The PROG we've been looking at is really at 28635 pes TA 
and the actual value, under which the system is operat- 2 Bt = 
ing is at 23635. We know that the program begins at 22 2 T gree a 
an 28755 so we can POKE that data into PROG and fool „+ =~ i 
the system for a while. 28755 = 83,112 So: Tas z 
POKE 23635,83 zs 2 
POKE 23635,112 i 
7. LIST your program, The very beginning of the first 
line is garbage like Fig.4, but you can figure out The POKE 23613,9 lines, which mess up the error handling 
from Fig.2 or 3 what those few bytes were (in this . (e.g. causing a system reset when you try to "break" the progr 
case it was 01 POKE. Try COPY or LLIST if you want for example), can be replaced by POKE 23670,¢0 &uich is innocu: 
a more permanent record. You could now simply type in enough, and maintains program length)or simply eliminated. it 
the program and, given that the author didn't enter they are eliminated, the program becomes shorter and faster. 
any variables as direct commands, it would work. 


There is an easier way, however, 


P 3 LONG ISLAND SINCLAIR TIMEX GROUP 


LONG ISLAND 


7 f: 
: Z ha SINCLAIR TIMEX 
8. Tum off your machine and perform steps i1 baits pi ONTEN i$ GROUP 
again. Remember that we have loaded the code 5000 bytes Seene ue 
higher than when it was saved. If the program doesn't LOCATION NAME {LSB MSB) DEcrma PESIRED CONTENTS 
dynamically define too many new variables we can stick Ri: i ee ees 
with this 5000 byte offset. TT does however, and if we . 133552 K STATE N/A 65280 
redefine all the systems variables to points 5000 higher a id 
we end up running out of memory later. We'll move the 
Program down another 1792 bytes to allow it to grow. os 
f Oe res 23613,14 ERRSB 0,255 65280 24832 0,97 
Now look at the old system variables VARS (28627) toy- * 23615,16 LISTSP 81,255 65361 24913 81,97 
MEM (28656).* In each case, we must redefine the cS d 
location to which they point. VARS, for example, points =“ 
to 62593 (which means it was origninally at 57,593). We 23627,8 VARS 249,224 57593 60701 29,237 
want it to be at 60801 (1792 less) so we change the old 23629, 30 DEST 28,234 59932 63140 164, 246 
values: 23631,2 CHANS 182,92 23734 26942 62,105 
POKE 28627, 129 ` 129 23633,4 CURCHL* 182,92 23734 26910 30,105 
POKE 28628, 237 237 X 256 =60673 23635,6 PROG 203,92 23755 26963 83,105 
60801 23637,8 NXTLIN 28793 23836 27044 164,105 
23639, 40 DATADD 202,92 23754 26962 82,105 
The’ same must be done for most of the rest of these . 23641,2 ELINE 242,233 59890 63098 122,246 
variables. A particular exception, however is CHANS 23643,4 KCUR 244,233 59892 63100 124, 246 
(& CURCHL) which, as you can see, point to 23734. Look- 23645,6 CHADD 27,93 23835 27043 163,105 
ing at Page 255 in the manual, we want the CHANS data 23647,8 XPTR N/A - - = 
(those bytes from 23734 through 23754 in the original 23649 ,50 WORKSD 252,233 59900 63100 132,246 
Program) to be just below the PROGRAM area, There are 23651,2 STKBOT 13,234 59917 63125 149, 246 
some 21 bytes and they will start, therefore, at 26942, 23653,4 STKEND 13,234 59917 63125 149, 246 
while PROG will end up at 26963. 23655 BRER 142 N/A - 142 
23656,7 MEM 146,92 N/A = 146,92 


A little confusing at this point, so lets recap: 


23730 ni 
a) We loaded the code 5000 bytes higher Ñ 


through originally intended. + ARS BUF? » ichs iust 


b) That -code contains the system variables 
and the program. 


ce) Sti fooling around above RAMTOP (28552) 
we poked new values into the systems var- 
iables which would reflect the relative 
offset of 5000 (actual) less 1792 (desired) 
or 3208. This was to give more space for 
VARS to grow, 


SUG Tp ype 


d) If we could now move this corrected code 
where it belongs: i.e., the variables from 
28552 through 28733 down to 23552 and, si- 
multaneously, the Program (& CHANS) down to 
26963 (26942 for CHANS), we would have a 
runnable program. 


wo 


n 


Oww Ge 


Libs 


UNMIS 


VEDI Lape 


VEG 
j 
7I 


WD- e ju 
CR ST A 


iW 


fdt 
ue UD 
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9. The first few lines of Fig.l do that for us. They are a at 
machine code LDIR routine, All that needs to be done now 4 
is to RUN the little program and then:' 3 


O 
= 
z 


woy 


-wj Oren 
2 JV 
Wes w 

Wm ey 


e 


LET A = USR 24606: STOP 


z 


The information will be put where it's supposed to be and 
the program can be run by typing 


we 
uate 


3 


CLEAR. . 
GOTO 2. I 


The machine Code is given in Fig.5 4 
. 


You've now got a working copy of Transylvain Tower. The Same technique should 

work for most such Spectrum BASIC programs.*# Be careful though, to check each 4 
variable, one at a time, as they really can point anywhere. TT was "easy" be- 

cause everything was in order. Other programs may not be that way. Also note 

that you still have to do a little BASIC "cleaning" of the Program. Lines 1 and 

7720 contain the statement SAVE "tower" CODE 23552, 36,500 - which must be changed 

to reflect your new configuration. Also, the keyword "STICK" will appear where- 

ever the graphic "1" exists on the SPECTRUM. 


If you've developed on this system, let us know and we'll add your comments to this 

report. ‘As an example, lines 100 to 140 allow input of values to be POKED, starting 
at address "U", A more sophisticated program might ask for a starting address (e.g, 
28635) and ending address (e.g., 23653) and an offset and then automatically adjust 

the bytes at those locations for you. 


xa 


TU n 


THE MACHINE CODE 


Ss 


LDBC with 181 - # Bytes to be Transfered G1,181,¢ 

LDDE with Destination address (23552) 17,0,92 

LDHL with Source of Code (28552) 33,136,11 

LDIR Transfer the code x 237,176, 

LDBE with 36,500 bytes 1,148,142 N 


LDDE with Destination 26942 (CHANS & PROG) 17,62,105 

LDHL with Source 28734 (original GHAMS &PROG).33, 62,112 

LDIR Transfer the data 237,176 á 
RET Return to BASIC 201 


` 


7 
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Fig. 5 is 


** It works, for example, on "Everest Ascent”. HOFF T sooo werd 
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TIMEX APPLICATION NOTE: INTERFACING WITH BROTHER'S EP44 TYPEWRITER 
eee Ae 


EQUIPMENT REQUIRED: 1) TS 1000/ZX 81 


2) Byte Back MD-2 Modem with RS232 Port 
3) Brother EP-44 portable typewriter 
4) 14 pin dip header, wire & 25 PIN "D" connector 


Brother's EP-44 hi-resolution, dot-matrix printer uses regular and/or thermal 
Paper (up to 8 1/2" wide), can be battery operated and is a full function- 
typewriter. It also has 4K memory for text and an RS-232 port. Priced 
between $269 and 300, it is a good buy simply as a portable typewriter. With 
Byte back's MD-2 Modem/RS 232 port, the EP-44 can serve as your printer. 


To make this connection, begin by removing the right hand cover plate of your 
MD-2 unit. Inside, you'll see the backward mounted 14 pin DIP socket shown 
in Fig. 3. The numbers on the pins are tricky because of this back-side 
mounting, so be particularly observant. 


Assemble your interface cable using the pinouts shown in Figs. 1,2, & 3. Only 
3 wires (and possibly just 2) are needed for this interface, they are: 


1) Ground-connect pin 7 of the DB 25 connector to pin 
7 on your Byte Back board (use a DIP HEADER). 


2) DATA TO THE PRINTER This means the Timex will be 
transmitting (pin 2) and the EP-44 will be receiving 
(pin 3 on DB-25) 


3) EXTERNAL READY - CLEAR TO SEND - (In fact, we could 
probably dispense with this one or use RTS). External 
Ready (pin 20) on the printer tells the Timex's Clear 
to Send (pin 5 or DIP) that it is ready to listen to 
data. 


Now plug in the EP-44 and MD-2 using your cable. Put the MD-2 on the back of 

a TS 1000, power up and LOAD or Key in the Byte Back software. Switch the EP-44 
on and put it in terminal mode (OFF Line). Enter the configuration shown in Fig 
as the printer modes. The BASIC software listing supplied, free, by Byte Back ` 
was used to generate the character set and message shown below: 


THIS IS TO INFORM YOU THAT 


! #S%8' O es, =, 0123456789: ; <=> ?@ABCDEFGHI JELMNOPQRSTUVWXYZ(\)*_ abcde fghi jk 
Parstuvwxyz{j}~ ‘ 


As supplied, you can only use LPRINT, not LLIST & COPY. This also limits you to 
32 characters per line for standard text. Byte Back has a program which will 
give you full features at $29.95. 


` 


u 


This system is easy to hook up and quite reliable. I don't know which RS-232 
interface chips the Brother uses, but it appears quite rugged and flexible, as 
is the MD-2 modem. We only tested the:\zP-44 as a printer, but by connecting 


the remaining RXD and TXD lines and `RIS, CTS, you could use the EP-44 as a 
"big keyboard". LARNI 


Finally, though we've not 100% sure of this, it may even be possible to tap 
into the EP-44's 4K of CMOS, battery backed-up RAM. This means you could add 
4K RAM and, have "almost" instant load software, as long as it was under 4K. 


s2- 
ByteBack 
SINCLAIR TIMER 


EP44 to be vesd os on output printer [or personni computers, 
1. CONNECTION 


CABLE 
2 CONNECTING Comprraneep 

STRLAT® TODS EP44 

RAUÐ RATE 190 BAUD RATE 300 

ay » BIT LENGTH 7 . 

BIT LENGTH 8 PARITY z # eN 

STOP err 2 NEWLINE CROLF , TR 
cova sor - 
ER Y $ 


ByteBack 
RS—232 Output Plug. 
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J. Data Terminal Ready (QTE) 
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rte. 9 Resolved Data Outpes 


AS VIEWED PRON THE COMPONENE SIDE OF TME BOARD 

Ngga, "ne sockets ie on the baek op circuit 
slde of the beard. dut the ping are 
nuadered se shown viewed froe tae 
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i BYTE -BACK CO. 


M0-2 MODEM 
LOSIC DIAGRAM 
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n t , i4 


IRAS 232ICI comer we 


NUTE: Hand shaking 
tt Hecepton 

@ Heceptiun s possible when DA and CO are ON: reception data is ignored at 
vther men, 

Sit ER n set, ER line e ON when data can be received, but becomes OFP 
when busy (nnat bulter remander is low and deta cannot be received). 


12) Trammnuon 
Cate ts wenemuttad when OR and CS are Oft. 


33 
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